NOTICE 


THIS DOCUMENT HAS BEEN REPRODUCED FROM 
MICROFICHE. ALTHOUGH IT IS RECOGNIZED THAT 
CERTAIN PORTIONS ARE ILLEGIBLE, IT IS BEING RELEASED 
IN THE INTEREST OF MAKING AVAILABLE AS MUCH 
INFORMATION AS POSSIBLE 



Made •witablc under NASA sponsofite 
In themterfist of early and wide dis- 
seniinatton of Earfh Resources Survey 

'*'*^*’®“* 1^^^ "AS-BUILT” DESIGN SPECIFICATION 

wr any use made thereof." 

FOR 


I' 

FIELD STATISTICS (FIELDSTAT) 


8 . 0 ' 

JSC-14487 


188^* 




Job Order 71-475 


(TIRF 78-0011) 

(EdO-lU2S2) AS-BUILT DESIGN ofEc IFICATION N80-30835 

fOH FIELD STATISTICS (FIElDSTAT) (Lock.aeed 
BiectfOtii.cs Co.) ‘•J9 p HC ACj/SF AJi 

Ci»CL OliS UiiCias 

G3/43 00252 

Prepared By 

Lockheed Electronics Company, Inc. 

Systems and Services Division 
Houston, Texas 
Contract NAS 9-15200 
For 

EARTH OBSERVATIONS DIVISION 
SPACE AND LIFE SCIENCES DIRECTORATE 



National Aeronautics and Space Administration 

LYNDON B. JOHNSON SPACE CENTER 

Houston^ Texas 


September 1978 


leg- 12804 


JSC-14487 


''AS-BUILT'' DESIGN SPECIFICATION 
FDR 

FIELD STATISTICS (FIELDGTAT) 

Job Order 71-475 
(TIRF 78-0011) 


Prepared By 
D. K. McCarley 


APPROVED BY 



Pb^lip. L. Krumm, Acting Supervisor 

iti"®'" * — . . 


Lentific Applications Section 


Prepared By 

Lockheed Electronics Company, Inc. 

For 

Earth Observations Division 

NATIONAL AERONAUTICS AND SPACE ADMINISTRATION 
LYNDON B. JOHNSON SPACE CENTER 
HOUSTON, TEXAS 


September 1978 LEC-12804 


i 


CONTENTS 


Section Page 

1. INTRODUCTION. . 1-1 

2. APPLICABLE DOCUMENTS ..... 2-1 

3. SYSTEM DESCRIPTION 3-3 

3.1 GENERAL 3-1 

3.2 DATA FLOW DIAGRAMS 3-2 

3.2.1 IMUNLD DATA PLOW . 3-2 

3.2.2 PLDSTT DATA PLOW 3-2 

3.3 FILE DESCRIPTIONS 3-2 

3.3.1 IMAGE UNLOAD TAPE PILE (Input only). ... 3-2 

3.3.2 SCREENED IMAGE DISK PILE - SGNMACQDT . IM0 

(Output/ Input) 3-6 

3.3.3 IMUNLD.DAT DISK PILE (Input only) .... 3-6 

3.3.4 HEDREC.SIT DISK FILE (Input only) .... 3-7 

3.3.5 PLDSTT.DAT DISK PILE (Input only) .... 3-7 

3.3.6 FSTLBL.DAT DISK PILE (Input only) .... 3-9 

3.3.7 GROUND TRUTH DISK PILE - SGNMGENDT.GT0 

(Input only) 3-9 

3.3.8 DOT PIXEL STATISTICS DISK PILE - SGNMACQDT . DP0 

(Output only) 3-11 

3.3.9 PURE PIXEL STATISTICS DISK PILE - SGNMACQDT . PP0 

(Output only) . 3-14 

3.3.10 MIXED PIXEL STATISTICS DISK FILE - SGNMACQDT . MP0 

(Output only) ‘ . 3-15 

3.3.11 SU3PIXEL STATISTICS DISK PILE - SGNMACQDT . SP0 

(Output only) 3-15 

3.3.12 SCRATCH PILE - TMPSTT.TMP (Input/Output). . 3-17 

ii 


Section Page 

3.4 DETAILED DESIGN. 3 -I 9 

3.4.1 IMAGE UNLOAD MAIN PROGRAM (IMUNLD) . . . . 3 -19 

3.4.2 IMUNLD SUBROUTINES 3-24 

3.4.3 PIELDSTATS MAIN PROGRAM (FLDSTT) .... 3-45 

3.4.4 FLDSTT SUBROUTINES 3 -71 

4. OPERATIONS 4 -I 

4.1 OPERATOR'S GUIDE 4-1 I 

4.1.1 IMUNLD PROGRT^ 4-1 

4.1.2 FLDSTT PROGRAM 4 -I 

4.2 USER'S GUIDE 4-2 

4.2.1 BATCH PROCEDUilES 4-2 

4.2.2 ONLINE PROCEDURES 4 >5 

/ 


iii 


1. INTRODUCTION 


This document describes the implementation details of the Field 
Statistics (PIELDSTAT) Program which is designed to provide 
statistics describing the signatures of the crop classes (as 
determined by ground truth) in a Large Area Crop Inventory 
Experiment (LACIE) segment. Included are details on the Image 
Unload Program which transfers raw image data from magnetic 
tapes to a disk data base during a screening and tagging process. 
The screened image data and existing ground truth data are 
correlated by the FIELDSTAT program ^and ground truth spectral 
value statistics files are produced. 


2 . APPLICABLE DOCUMENTS 


The following documents, of the exact issue noted, formed 
the basis of the software described in this document. 

o TIRE 78-0011 dated February 3, 1978. 

o Field Statistics (FIELDSTAT) Implementation Specification 
Document for Accuracy Assessment (LEC 12172) dated May,/ 1978. 


m 


3 . SYSTEM DESCRIPTION 


3.1 GENERAL 

The first program run is the Image Unload program, IMUNLD. It 
reads from a disk file named i.i4UN.t.D , DAT three items of 
information: the auxiliary disk device number, the magnetic 

tape device ID, and the magnetic tape number of the image 
unload tape. It then reads the blind site segment numbers 

from a disk file named HEDREC.SIT. Then it begins scanning the 
input tape and, when a desired segment is encountered, a disk 
file is created whose type is IM0 and whose name is the nine- 
character segment number and acquisition date combination. Next, 
each of the 117 scan line records is transferred from the tape 
to the disk file and, during the transfer, each of the 196 
pixels in a scan-line is passed through a screening process. If 
the pixel is not classified as good, it is tagged before being 
stored on the output disk file. When all of that file has been 
transferred, the disk file is closed. A disk file is created 
for each acquisition on the tape from a blind site segment. 

A report is produced which identifies each disk file created, 
the portion of the three-part data base where it was stored, and 
the results of the screening process. 

The second program that is run is the Fieldstats program, 

PLDSTT. The FLDSTT and IMUNLD programs are independent except 
that FLDSTT uses as input the files that are output from IMUNLD. 
FLDSTT reads from a disk file named FLDSTT.DAT several items 
of information: the crop code translations file ID, the ground 
truth data file ID, the LACIE segment number, an output report 
option flag, and from one to fifteen acquisition dates. The 
program reads crop code translations and brightness and 
greenness coefficients from the crop code translations file. 

It assigns the specified ground truth data file, and then. 


for each acquisition date input, that date is combined with 
the segment number to create the file names used fox one input 
disk file (image unload - type. IM0) and four output disk files. 
The four files output are the dot pixel statistics (type,D£0), 
the pure pixel statistics (type.PP0), the mixed pixel statistics 
(type.MP0), and the subpixel statistics (type.SP0). One scan 
line of data is read from the image unload file and from the 
ground truth file. For each of the 196 pixels in the scan line, 
counts and accumulations are made (on a per crop code basis) 
and kept on an interim scratch disk file. When all 117 scan 
lines have been processed, the data for the four output files 
are calculated and stored, and the desired output reports are 
generated. Then the process is repeated for the next acquisition 
date. 


3.2 DATA FLOW DIAGRAMS 

3.2.1 IMUNLD DATA FLOW 

Figure 3-1 illustrates the data flow for the IMUNLD program. 

3.2.2 PLDSTT DATA FLOW 

Figure 3-2 illustrates the data flow for the FLDSTT progrsim. 

3.3 FILE DESCRIPTIONS 

3.3.1 IMAGE UNLOAD TAPE PILE (Input only) 

This tape contains the four channels of image data for an 
acquisition in one file. There may be as many as 100 files on 
the tape. Each file is in the Universal Format, consisting of 
one 3060-byte header record, 117 900-byte data records, and one 
end -of “file record. The end of tape is denoted by two consecu- 
tive end-of-file records. The information of interest in the 
header is described below. 



TO FLDSTT 


I M U NLP DATA FLOW 




1 


I 



FLDSTT DATA FLOW 

FtaOKe 3-t 






BYTE 

1-32 

33-38 

39-60 

61-63 

61 

62 

63 

64-66 

67-68 

69-2200 

2201-2202 

2203-2248 

2249-2253 

2254-3060 


CONTENTS 

Tape title in EBCDIC: lACIE PPC IMAGE UNLOAD TAPE 

Tape number in EBCDIC 

N/A 

Date of this tape generation 

Day of month in binary 

Month number in binary 

Last two digits of year in binary 

N/A 

Segment number in binary (bytes inverted) 

N/A 

Sun angle in degrees in binary (bytes inverted) 

N/A 

Acquisition date in EBCDIC in YYDDD format 
N/A 


The information of interest in each data record (which represents 
one scan line) is described below. 


BYTE 

1-72 

73-268 

269-464 

465-660 

661-856 

857-900 


CONTENTS 

N/A 

Channel one values for pixels 1-196 in binary 

Channel two values 

Channel three values 

Channel four values 

N/A 



3.3 SCREENED IMAGE DISK FILE - SGNMACQDT . IM0 (OUtput/Input) 

The screened image file is a sequential, unformatted, FILES 11 
disk file in Universal Format and is essentially a copy of 
the corresponding (segment number and acquisition date) file on 
the image unload tape. The distinction in the data records is 
that the channel four value for a pixel (which normally ranges 
from 0-127) is increased by 128 if the screening process 
determines that the pixel is not good. The header record is 
copied exactly from the tape with the following exceptions? 

a. The new EBCDIC file title (bytes 1-32) is PIELDSTAT 
SCREENED IMAGE FILE. 

b. The segment number bytes (67 and 68) are in their proper 
order . 

c. The current date is stored in bytes 61-63. 

3.3.3 IMUNLD.DAT DISK PILE (Input only) 

This sequential, formatted disk file is a card-image file used 
to supply general information for any particular run of the 
IMUNLD program. Its format is as follows; 


RECORD 

CHARACTER 

CONTENTS 

1 

1 

Device number of the disk onto which 
the IMUNLD is to store the screened 
image files. For example, if DB2: 
is the disk device used, then this 
record would contain a 2 . 

2 

1-3 

Magnetic tape device ID for input Image 
Unload tape, e.g., MTl. 

3 

1-6 

The Image Unload tape number, e.g., 
770080. 


3.3.4 HEDREC.SIT DISK PILE (Input only) 

This sequential f unfomatted disk file contains all the valid 
blind site segment numbers in one record as binary integers. 

The first 64 words are the 64 segments pertaining to Part 1 
of the Accuracy Assessment (AA) data base. The second 64 words 
are the 64 segments pertaining to Part 2 of the AA data base, 
and the third 64 words are the 64 segments pertaining to Part 3 
of the AA data base. 

3.3.5 FLDSTT.DAT DISK FILE (Input only) 

This sequential, formatted disk file is a card-image file used 
to supply general information for any particular run of the 
PLDSTT program. Its format is as follows: 

RECORD CHARACTER CONTENTS 

1 1-30 Pile ID where the crop code translations 

and brightness and greenness coefficients 
are stored. The file name is PSTLBL.DAT, 
but this field should include the 
specific device and User Pile Directory 
(UPD) to enable location of the desired 
file, e.g., DB2; [131, )J01] PSTLBL.DAT. 

2 1-30 Pile ID where the ground truth data are 

stored. After this file is assigned, 
then this character string is used to 
create output files, therefore it must 
be very exact in format. For example, 
the file ID DB2 : [131, i?j2fl] 161177353 .GT0 
is acceptable (the acquisition date 
must be characters 18-22) . 


3 


1-4 


Segment number to be processed. 


RECORD 


CHARACTER 


CONTENTS 


3 6-7 


3 9-10 


4 1-5 


4 

4 

4 

4 

5 
5 
5 


11-15 

21-25 

31-35 

41-45 

I- 5 

II- 15 
21-25 


Output report option flag. A two-digit 
decimal number specifying which output 
reports are desired. The number is the 
sum of the numbers assigned to the 
various reports. The Acquisition 
Summary report is always produced, 
whereas the Dot Pixel Statistics report 
(assigned number 1) and the Crop Code 
Summary report (assigned number 2) are 
optional. 

A two-digit decimal number, greater 
than zero and less than sixteen, which 
specifies how many acquisition dates 
are to be processed during this run 
of the PLDSTT program. 

First acquisition date to be processed. 
Represented in standard YYDDD format. 

As many acquisition dates as are 
indicated on record three should be 
specified in successive fields on 
records four, five, and six. 

Second acquisition date. 

Third acquisition date. 

Fourth acquisition date. 

Fifth acquisition date. 

Sixth acquisition date. 

Seventh acquisition date. 

Eighth acquisition date. 

Ninth acquisition date. 



/ 


d 


5 


31-35 


RECORD 

CHARACTER 

CONTENTS 

5 

41-45 

Tenth acquisition date. 

6 

1-5 

Eleventh acquisition date. 

6 

11-15 

Twelfth acquisition date. 

6 

21-25 

Thirteenth acquisition date. 

6 

31-35 

Fourteenth acquisition date. 

6 

41-45 

Fifteenth acquisition date. 


3.3.6 PSTT.BL.DAT DISK FILE (Input only) 

This sequential, formatted disk file is a card image file used 
to supply crop code translations and brightness and greenness 
coefficients to the FLDSTT program. The first sixteen cards 
each contain sixteen five-character fields. The first three 
characters of each field are the numeric crop code, and the 
last two characters are the alphanumeric translations. These 
fields must be in ascending numerical sequence, 000-255. The 
seventeenth card contains the four brightness coefficients 
beginning at character one and separated by commas. The 
eighteenth card contains the four greenness coefficients 
beginning at character one and separated by commas. 

3.3.7 GROUND TRUTH DISK PILE - SGNMGENDT . GT0 (Input only) 

The ground truth file is a sequential, unformatted, PILES 11 
disk file in Universal format, with one 3060-byte header record 
and 351 540-byte data records. The only information in the 
header record that is of interest to the FLDSTT program is the 
segment number, stored in word thirty-four, which is checked 
against the specified segment number from the FLDSTT.DAT file. 

In ground truth data, which records actual crop codes, each pixel 
is divided into six subpixels (three rows by two columns) , so 
that one scan line across the 196 pixels actually records values 
for 2*196 subpixels, and three scan lines are needed to record values 


for the complete 196 pixels in each of the 117 pixel rows. 
Consequently, there are 3*117=*351 data records, each of which 
contains crop code values for two subpixels out of each of the 


196 pixels 

in the scan line. The information in the data 

records is 

laid out 

as follows: 

R'^CORD 

BYTE 

CONTENTS 

1 

1-72 

N/A 

1 

73 

Crop code for upper left subpixel of pixel 
one in row one. 

1 

74 

Crop code for upper right subpixel of pixel 
one in row one. 

1 

75 

Crop code for upper left subpixel of pixel 

• 

• 

two in row one. 
• 

• 

• 

1 

• 

• 

464 

• 

0 

Crop code for upper right subpixel of pixel 



196 in row one. 

1 

465-540 

N/A 

2 

1-72 

N/A 

2 

73 

Crop code for middle left subpixel of pixel 

• 

• 

one in row one. 
* 

• 

• 

2 

• 

• 

464 

9 

9 

Crop code for middle right subpixel of pixel 



196 in row one. 

2 

465-540 

N/A 

3 

1-72 

N/A 



RECORD 

BYTE 

CONTENTS 




3 

73 

Crop code for lower 

left subpixel 

of 

pixel 

• 

• 

one in row one 

• 




• 

• 

3 

• 

• 

464 

* 

• 

Crop code for lower 

right subpixel 

of 

pixel 



196 in row one. 




3 

465-540 

N/A 




4 

1-72 

N/A 




4 

73 

Crop code for upper 

left subpixel 

of 

pixel 

• 

• 

one in row two. 

• 




• 

• 

351 

• 

• 

464 

• 

• 

Crop code for lower 

right subpixel 

of 

pixel 



196 in row 117. 




351 

465-540 

N/A 





It should be noted that the value of each crop code is biased by 
-128 if looked at as an eight-bit computer word. 

3.3.8 DOT PIXEL STATISTICS DISK PILE - SGNMACQDT . DP0 (Output only) 

The dot pixel statistics file is a sequential, unformatted, FILES 
11 disk file with one 360-word header (two bytes per word) and 
eleven 270-word data records. The format of the header record 
is as follows: 

WORD CONTENTS (binary single word integer except as noted) 

1-5 PIELDSTATS (ASCII characters) 



WORD 


CONTENTS 


6-8 Date of file generations 

Word 6 “ day of the month 
Word 7 = month number 

Word 8 a value of the last two digits of the year 
9 Segment number 

10-11 Acquisition date (double word binary integer) 

12 Sun angle in degrees 

13 Number of good pixels 

14 Number of garbled pixels 

15 Number of cloud pixels 

16 Number of shadow pixels 

17 Number of water pixels 

18-19 Channel one means (real) 

20-21 Channel two means (real) 

22-23 Channel three means (real) 

24-25 Channel four means (real) 

26-27 Gamma (real) 

28 Number of one-class pixels 

29 Number of two-class pixels 

30 Number of three-class pixels 

31 Number of four-class pixels 

32 Number of five-class pixels 

33 Number of six-class pixels 

34 Number of different crop codes encountered in good 
pixels. 


WORD 


CONTENTS 


35-290 Crop code occurrance array. Applicable only to the 

pure pixel, mixed pixel, and subpixel statistics 
files. Each word corresponds to crop codes 0-255, 
in that order, A zero in the word means that crop 
code did not occur. A value, I, in the Jth word 
means that crop code J-1 did occur, and the statistics 
for that crop code are recorded in record I (header 
record excluded) of the file. 

291-360 Zero fill. 

Each data record contains nineteen twelve-word blocks of infor- 
mation in the first 228 words of the record and zero fill in 

the last forty -two words. Each block of information pertains to 

one of the designated 209 dot pixels and is laid out as follows: 

WORD CONTENTS (all are single-word binary integers) 

1 Dot ID, range 1-209 

2 Channel one spectral value, range 0-255 

3 Channel two spectral value, range 0-255 

4 Channel three spectral value, range 0-255 

5 Channel four spectral value, range 0-127 

6 Subpixel one crop code, range 0-255 

7 Subpixel two crop code, range 0-255 

8 Subpixel three crop code, range 0-255 

9 Subpixel four crop code, range 0-255 

10 Subpixel five crop code, range 0-255 

11 Subpixel six crop code, range 0-255 

12 Screening label, range 1-47 


3.3.9 PURE PIXEL STATISTICS DISK PILE - SGNMACQDT . PP0 (Output only) 

The pure pixel statistics file is a sequential, unformatted, 

FILES 11 disk file with one 360-word header record and from 
zero to 256 630-word data records. The header record is 
identical to the dot pixel statistics file header record. There 
will be one data record for each different crop code found in 
the good pixels of the segment. A pure pixel is a good pixel 
whose subpixels all have the same crop code. For a crop code 
detected in the segment, but having no pure pixels with that 
crop code, the data record will contain all zeroes except the 
first word, which will contain the crop codevalue. For crop 
codes that did have pure pixels, the data records have the 
following format; 

WORD CONTENT (single word binary integer except as noted) 

1 Crop code 

2-3 Channel one means (real) 

4-5 Channel two means (real) 

6-7 Channel three means (real) 

8-9 Channel four means (real) 

10-11 Channel one standard deviation (real) 

12-13 Channel two standard deviation (real) 

14-15 Channel three standard deviation (real) 

16-17 Channel four standard deviation (real) 

18-19 Channels 1x2 correlation (real) 

20-21 Channels 1x3 correlation (real) 

22-23 Channels 1x4 correlation (real) 

24-25 Channels 2x3 correlation (real) 

26-27 Channels 2x4 correlation (real) 


WORD 


CONTENT 


28-29 Channels 3x4 correlation (real) 

30 Pixel count 

31-181 Brightness histogram, 151 words representing counts 

of values 0-150 

182-297 Greenness histogram, 116 words representing counts 
of values (-30) -85 

298-630 Zero fill. 

3.3.10 MIXED PIXEL STATISTICS DISK PILE - SGNMACQDT.MP0 (Output only) 

The mixed pixel statistics file is a sequential, unformatted, 

PILES 11 dis)c file with one 360-word header record and from 
zero to 256 630-word data records,, The header record is 
identical to the dot pixel statistics file header record. There 
will be one data record for each different crop code found in the 
good pixels of the segment. A mixed pixel for a certain crop 
code is a good pixel with at least one subpixel having that 
crop code. Note that this definition includes pure pixels as a 
subset of mixed pixels. Each data record has exactly the same 
format as a pure pixel statistics file data record. 

3.3.11 SUBPIXEL STATISTICS DISK PILE - SGNMACQDT . SP0 (Output only) 

The subpixel statistics file is a sequential, unformatted, PILES 
11 disk file with one 360-word header record and from zero to 
256 630-word data records. The header record is identical to 
the dot pixel statistics file header record. There will be one 
data record for each different crop code found in the good 
pixels of the segment. Each data record will have the following 
format; 



w 


WORD 


CONTENTS (double word binary integer except as noted) 


1 

2-3 

4-5 

6-7 

8-9 

10-11 

12-13 

14-15 

16-17 

18-19 

20-21 

22-23 

24-25 

26-27 

28-29 

30-31 

32-333 

334-565 


Crop code (single word binary integer) 

Channel one means (real) 

Cham, el two means (real) 

Channel three means (real) 

Channel four means (real) 

Channel one standard deviation (real) 

Channel two standard deviation (real) 

Channel three standard deviation (real) 

Channel four standard deviation (real) 

Channels 1x2 correlation (real) 

Channels 1x3 correlation (real) y 

Channels 1x4 correlation (real) 

Channels 2x3 correlation (real) 

Channels 2x4 correlation (real) 

Channels 3x4 correlation (real) 

Subpixel count 

Brightness histogram, 151 integers representing 
counts of values 0-150 

Greenness histogram, 116 integers representing counts 
of values (-30) -85 


566-630 


Zero fill 


3.3.12 SCRATCH PILE - TMPSTT.TMP (Input/Output) 

The program PLDSTT uses a direct access^ unformatted, scratch 
disk file, that has 1260 words per record. The first 256 
records are reserved for interim storage of counts and 
accumulations on a per crop code basis. Records 257 through 
267 are used for interim storage of the dot pixel statistics 
file data records and are formatted exactly like those records. 
The format of any one of the 256 crop code statistics records 
is as follows: 

WORD CONTENTS (single word binary integers except as noted) 

1 Crop code 

2,3 Sura of pure pixel channel one values (double word 

binary integer (DWBX)) 

4,5 Sum of pure pixel channel two values (OWBI) 

6,7 Sura of pure pixel channel three values (DWBI) 

8,9 Sum of pure pixel channel four values (DWBI) 


10,11 

Sum 

of 

channels 

1x1 

products 

(DWBI) 

- 

pure 

pixels 

12,13 

Sum 

of 

channels 

1x2 

products 

(DWBI) 


pure 

pixels 

14,15 

Sum 

of 

channels 

1x3 

products 

(DWBI) 


pure 

pixels 

16,17 

Sum 

of 

channels 

1x4 

products 

(DWBI) 

- 

pure 

pixels 

18,19 

Sum 

of 

channels 

2x2 

products 

(DWBI) 

- 

pure 

pixels 

20,21 

Sum 

of 

channels 

2x3 

products 

(DWBI) 

- 

pure 

pixels 

22,23 

Sum 

of 

channels 

2x4 

products 

(DWBI) 

- 

pure 

pixels 

24,25 

Sum 

of 

channels 

3x3 

products 

(DWBI) 

- 

pure 

pixels 

26,27 

Sum 

of 

channels 

3x4 

products 

(DWBI) 


pure 

pixels 

28,29 

Sum 

of 

channels 

4x4 

products 

(DWBI) 


pure 

pixels 


30 Pure pixel count 


WORD 

31-181 

182-297 

298-593 

594-621 

622-1157 


CONTENTS 

Pure pixel brightness counters, 151 integers 
representing values 0-150 

Pure pixel greenness counters, 116 integers > 
representing values (-30) -85 

Repeat of words 2-297 except for mixed pixels 

Repeat of words 2-29 except for subpixels 

Repeat of words 30-297 except OWBI for subpixels. 



3.4 DETAILED DESIGN 


3.4.1 IMAGE UNLOAD MAIN PROGRAM (IMUNLD) 

3.4.1.x Linkage 

This program calls the special subroutines BEGRPT, PBLD, and 
PSTART in addition to system subroutines. 

I 

3. 4. 1.2 Interface 
BEGRPT, PBLD, PSTART 

3 . 4 . 1 . 3 Input 

An Image Unload tape, a blind site segment numbers disk file, 
and a program parameters disk file. 

3. 4. 1.4 Output 

Screened image disk files for use by at least the PLDSTT program, 
and a report showing, for each screened image disk file produced, 
the file name, the part of the AA data base into which it was 
stored, and the count of good, garbled, cloud, shadow, and water 
pixels. 


3. 4. 1.5 Storage 
15,334 words. 

3. 4. 1.6 Description 

This program scans files on an Image Unload tape and, for each 
blind site segment it finds, it creates a disk file of the same 
data after screening each pixel and flagging those which are 
not good. 
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3.4.2 IMUNLD SUBROUTINES 

3. 4. 2.1 General 

The special subroutines called by IMUNLD are BEGRPTr FBLD, and 
PSTART. PSTART calls special subroutines ETOA and SCREEN. 
BEGRPT has an additional entry point RPTLN, referenced by PBLD. 
PSTART has additional entry points HDRIN^ referenced by IMUNLD, 
and DATOUT, referenced by PBLD. SCREEN has an additional entry 
point SNAG, referenced by PSTART. 

3. 4. 2. 2 Subroutine BEGRPT 

This subroutine prints the header and each line of the output 
report. 
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3. 4. 2. 3 Subroutine FBLD 

subroutine creates the proper file name, opens that file, 
transfers the data to it, closes it, and reports on it. 
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3 . 4 . 2 . 4 Subroutine FSTART 


This subroutine sets up the tape drive, reads each file's 
header record, reads and screens the data from a particular 
file, and writes the output disk file. 
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3 . 4 . 2 . 5 Subroutine ETOA 

This subroutine converts an alphanumeric tape number from 
EBCDIC to ASCII characters. 
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3. 4. 2. 6 Subroutine SCREEN 

This subroutine, using the sun angle and the four channel 
values. for a pixel, makes a series of tests and decides 
whether the pixel is good, garbled, cloud, shadow, or water. 
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3.4.3 FIELDSTATS MAIN PROGRAM (FLDSTT) 

3. 4. 3.1 Linkage 

This program calls the special subroutines GAMGEN, SCREEN, 
GETCCR, PASRPT, PGPRPT, and PCCSRP in addition to system 
subroutines . 

3. 4. 3. 2 Interface 

GAMGEN, SCREEN, GETCCR, FASRPT, FGPRPT, FCCSRP. 

3. 4. 3. 3 Input 

A screened image disk file, a ground truth disk file, a crop 
code translations disk file, and a progreun parameters disk 
file. 


3. 4. 3. 4 Output 

A dot pixel statistics disk file, a pure pixel statistics disk 
file, a mixed pixel statistics disk file, a subpixel statistics 
disk file, an acquisition summary report, an optional dot pixel 
statistics report, and an optional crop code summary report. 

3. 4. 3. 5 Storage 
25,360 words. 

3.4. 3.6 Description 

The FLDSTT program matches image unload data and ground truth 
data, calculates means, standard deviations, cross-channel 
correlations, and brightness and greenness histograms, stores 
these statistics on disk files, and produces reports on them. 
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FHD,T{I*27)sPCC(I> I PIXFL CLASS CPL^^eHS 
820 CDMTrv.ie I L«?P SND 

Sf^^RP CR?P CT'OE ARRAY AN*^ LUM3PR 2F CH0F CPDESi 
NCCCcO 

DU 830 I*1#256 
lF(CrAn).PQ.C)r,3 T0 630 
•N0CCeN?CC*l 
FHDR( I*34)sVf'CC 
830 CONTI •'I'lfc I L!V,P HND 
FhOR<34)»N2CC 
835 CKNTliM'lE 

WRITF H&ADfR RGCDRP TO TML FILES, _ 

‘ 04 8A0 1*1, •) ' 

WRITP('!nIT';c(I ) )FH''R 
840 CBM IN' '6 ! Lit'”P CVD 

transfer Df’T PIXFL STATS fRa'-' Ti-lP, TF fiNAL FILE, 

DC S50 1*257, ■•<>7 
‘vEACia* I )D 'T'm:F 

WFIlDC-OCFTt.l'f • ■ • 


ooo ooo oooo oooooo 00C50 a c 


T30 0. ,r 

'll !:(*;> 

in: •' I. (‘Of HD;'' 

r 

r I'ltli.r THr fin?STAT . C'UiU.l ru'!'.’ BlHhARV uEf'?r(T, 

c 

CAU. 'ATD 

r 

■'I'M .! 1 >*” rif'i tnjT/.T I Ix'-L in r-i-T, ir pf-sii'tn, 


If C.A 

(‘70 C I TI.'. 'K 

CAM, r':.p’^(->T(6,l’;)AT' ,1?) 
ndo C/ TI F. 

CL: S:"( ;NlTs'j) 

l^fT'^reVE T'lTrR'iELiI AT’’- tTATE PCCF.Ri: F "i(< EACH CCCUPRI F 0 CRCP 

C7;r,l:, 

ir (riP(MEQ.2)0 » T» to?5 
I'?. 1,12C 

ir(Cf:A(I)»1020. 1 020, 900 
900 CZFTltJ’iE 

RfcAn(3*CCA<l))TsREC 

STOMP CH;‘P C'^CE, 
rSRECf J )*TSRr;C(l> 

PEPr^RM A L^"ip 3 TIMES CALCULATINC STATISTICS F(iR PURE, MlXEP, 
ANM .'elUHTED PlXELS, . • 

00 900 J*0,296»1<I8 

FJ82*J*1 J Lv.‘RD PFIMTER Tv PRi'PPR ELFFfcR SECT12N, 

RET PIXEL r«i;\'T AS A REAL MU“BFR| .IF IT IS HER0, THEN. ZrR0 
PROPER P0RTI»m KF REClOPD E’FFER, 

IFfj’.EC, 296)02 T« 910 

CNTst$pEC(FJ* 29) J SINGLE WflRH INTEGER Tg REAL CdNV, 

00 Tf 1^20 

910 CBl'.'TlMiiE 
1*23? 

CNT*'^'PCNT I D'^USER word I'^EGER IV RfcAL CCNV, 

920 C0'iTi:'ne 

IF<C'"T,GT,0,0)'J2 TP 940 
D0 930 KsJ*l,J*L 
RFSR(K)s0,0 

930 C0NTlNi'E I LPaP ENO 
GR T? «90 
940 CflNTtwlE . 

CAI.CHLATS PER CHANNEL MEaSS, 

no 9‘50 K»J*1|J*4 
RrSR(-08TSR<K)/.",NT 
950 CJ(VTlw;e I L"AP RNn 

CAlC'ILATF. per CHANV6L ST’M DRV', 

Ks5 ' 

LM 




rsoo noo ooo ocin ooo oon 


I 


t 

I 


I 

1 

f 


Cam 

U'C; I .era, T ^ 9f>'> 

j* .i>s',i,;i 

RJ V' '>60 . ■ ' 

c«* n'r; 'k 

fn a T ■ 1 •<( J ♦ T «*■' r «i R ( j ♦!.*■■>) 0 F R r< ( J ♦ f- -< ) 

ir(.vr,'',ii,ri>ii;' t.- vf<ft 

( J»M > s J , I ■ 

r>ii r, 059 

95ft -F 

9H9 f >.)E 

K'j ':+i. 

LsL-1 

96D CO'iTlN.fK I 

CAl.C"LATf: rijr-'sS-nHAK JKL rFRHFtAT I , 

P3 970 K«ii 6 

0NMs(C- T-liO)*«f SK( J*1J {!<')♦< }»r:f'SR(^* IK (K) *4) 
ir (DMH'.GT,0)f!i’ TP 965 
RFSR( J + K*a>*t'.0 
GK T? 970 
965 C3 7TI.‘')UI: 

«Fr.R{ J+It (K) >-r',T#ft'rSR(\,T|vl(K) )#PfSR{ J+ IK<K) ) )/DNW 

970 CaflTtM'6 I LC i’R. F^^ 

TkaKSFER bRir.HTN(HSS A\r Rr.'»=(:MNSSS HISIPCRA^S T'Jl RECkJRD BUFFER 
L'29(A 

lF(j‘.f-'!,!>96)l. s5aA 
nitf 9ft0 KsFJ*29irJ*l 

rSRec<:<)#TSRrc(K> 

980 CwiNTtNi'E I L."UP fcNH . 

990 CO'ITl.Wi'E J Lf’PP 6Kt> 

* 

WRiTr, THE REC.-RDS' TI& THE Pt'TPUT FILES, 

WRlTl(l)rSREGU)»Pf»STT,ZrH'^tK 

WRITP<7)FS«EC(U»HPSTT,ZPi<.':I:S 

MRITE(M)FSRKC(l),WPSTT,SUt<7 

PRINT THE FiElPSTAT CRPP CPDE SUMMRY «EP0PT, IF DPSIRED'. 

IF <2’.a\'D»FLG) 1010,1010,1009 
1000 C<)'iTtNi!E 

CALL F9CSRP(;A,pdATP) 

1010 C.9NT?W'IE 

1020 C.TNrrME I L'^i'lP end . 

1025 CtJ >TI‘J IE 

CLcSP OUTPUT FILES’, 

P»1 1927 K'8?,4 
CL;''S'::<:'MTsUftT\3<K)) 

1027 CCNTinje j L:i'p E*'D 
1030 Ck?. TlN'.iE 

IF Tug NUHPr.'9 :’F ACUU I ft I T J <’ vS nESlOGP HavE HEEM F0UND, ThEN 
GU Tr- END PirnESSlvO, "T ikR-sIhP. Lil.'P tiACK F«R NEXT ACQ, 

IF (A^,OE,r. !A(.;^)9C’ Tl) IMO 


f 955 


t ?R 'l l'ST '.uffrn 


i i'f' 

RLi’S.' ( Te?) 

-’'M r. I < , <»OXV ' I T'aCl >*'’1 m ‘' i M (jCI|Ha • 

<”27 ) 

RT.W' 

tfin 
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3.4.4 FLDSTT SUBROUTINES 


3 . 4 . 4 . 1 General 

The special subroutines called by FLDSTT are GAMGEN, SCREEN, 
GETCCR, FASRPT, FGPRPT, and FCCSRP. SCREEN has an additional 
entry point SNAG, referenced by FLDSTT. 

3. 4. 4. 2 Subroutine GAMGEN 

This subroutine uses the sun angle and the four-channel mean 
vector of good pixels to compute the optical depth parameter, 
ganuna • 


F\o¥lfche^r 


fflZDQQRJ 


^R 04 KAM 

PtCLAtRTltfMS 


AllAt 1 A< •ri*l$^/l$9.0 
cr» ,lfT\%/ilN(tkH*) 


iO)’<K*X(l) 

i(t)*et*A(t) 

l(< 9 ) »CR«*fO 


UB»-nt90 ♦ itO)‘il-l)* 0.9H6 

91 * Bi- c.yTSf * (t(t) ~ss.i) *o.ofot 


ec 9 ‘B())*e.$ffS* 

If. tort 

»p*ntB 0 -i.o*fiA*c< 



P0*o.a 




<JA»A» fae- 


RETUI?N 










o o o o 


3 .‘t.t 2 b Lisf.nj 


SUJS?oTI'€ 

oamg;\ c 'h®cT 6 s T»e «$?*■» .icPt** p*p*“ETep n**'>** 

UZ IS Son ELEViTI’N I* “EGPfafeS 

* IS 4 C-<A*N;I. *•“*'. VECT"^ 'G»'2C» PUfUS 
jxA IS T-t£ n*i6 PASA^-tTES fOTPJT 

PC At X(4 )|uHA,E(4) 

INTECEp *2 IaO^ 


AlCilA^i *3,lAlS9 /IbC.P 
CW*,777l3/Sr(ANfi) 

C IN CASE PkASE 2 data IKSPPT CALlBAATias mEPE 

Z(?)tCP*X(2) 

E(3)tC'»*''C^> 

E(4)tCr.*X( 4) 

AAtl',6e7fl*<£(l>-6l.9)*<-0,M««5) 

AA»AA*l,091C«(7(2)-6^.?)»C'.<Pi3 

AA*AA^l,fl356*(H(3)»(J3»?)«u,Ci57 

AAiAA-0,S9Pl«(7(*>«37,9)»y‘. :4,3« 

8fls3n*l,0<A5*(?(2)-6*,2)*0‘. 4?o3 
9b«3n*n,9142»(('(3)-63,2)»0.C59 
0F»d:>-r ,7734*< H(4 )-33, 9)*T. 0< 0" 

CC»- 7 {l)* 0 |b 99 ‘’* 2 ( 2 )« 0 , 42 d'^P( 7 )*OiC 7 S 9 »£( 4 )« 0 , 340 A^U ,?082 
rC«»P*‘30*2tO»AA»CC 
IF(Dn ,lT. C.Q) ODiO.O 
. G;4Ai(ilr-S30T<D')) )/AA 

C 1<P!T£(16,2020)GMA 

2020 ,r79MAT(//i* GA<HA »*,rH,4,//J 

PETypi, 

ENP 


xxcotci: 
xxrc*: 2 : 
xxoc^oJ : 
XXC0'*C« * 
xxcof'cs: 
xxcoocf : 
xxco'’07: 

xxco''o* : 
xxco'tos : 
xxocpip : 
xxcoou : 
xxcooi?; 
xxco?*i3: 
xxcooiA : 

xxrof'is : 
xxco*'i6: 
xxco''i 7 ; 
xxco*i* : 

XXC 0019 : 

xxco'' 2 C : 
xxco'' 2 i : 
xxcoi' 2 ?: 

XXC0023 : 

xxco'' 2 < r 

XXC0r25 . 

xxco-^?*: 

XXC002’: 
XXC 002 ? : 
XXC0329: 
XXC003C: 

XXC003?: 


3. 4. 4. 3 Subroutine GETCCR 


This subroutine reads the direct access record corresponding 
to an input crop code and stores the record into a designated 
buffer area. 


u 


3. *f. ‘f, 3a Flo\i>/charf 

f 



r 
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CFTCC*’H'MT,C»C'CC|!»urKffi) 

This S'JH»?tTts^ rf>'H Th= i*POI W'.IT V?, TmP ^JPECT 

*cre«^’i pec’h*^ c.TPPESf’t’^i'r.c t/ the p.put cpjp *nd stjres 

IT I'T: The •'tSl'i.iT-fc .?t.T»6P, 

IMPuiClT r!TE‘*,E^*2 (*•/» 

.Tp'fe PurrE5fiuf) I jec„»:o 3urr£P 

C-3HM?',/CCARRr/* c“,cc/.(?5ft).crjc I C‘"2P CeoF ARRAY, ogc, P?P’Tcrs 
riciT Tl-e THP^O'ih, SET SP jl-irrcT, 

IF(» CT.eO.OSP T? 7 

-RITC C0»RE\T PurrFK ir AN^'TH6R Cfi.’P t<!Ce PcCi^D NEEDED, 
IF(CCP.Ew,-I )!*./ T'. 5 

irccci-, E 2 ,cf ’(,r>cETi,'. .g 

WRITeC ‘'tT'C''A<CCtC*l) )i? TfER 
9 C?' TIN- E 

IF RCC3R0 rxiSTS, C 4 TI 3C, 

IF{CrA(C‘’?Pcr*l).NF,fl)n^ T:' 30 
7 C «) ' 1 T ! Y I E 

CREATE A NF-. pECTRP, 

30'’F?.R(l)«Cn ’PC') 

RfUrrc3( I )«0 

10 CavTl J '6 

NJR«'C‘*1 ! !*'C®E'’E‘)T 'P, ZP CH 'P C ’CE RECZPDR, 

ccA(:.pPco*i'« :R i stzte .?/ p^p'teh cr'*p c'DE array, 

20 C2NT tv e 

CCIC8C!r®C0 1 SET TMiS CR'P COO? AS CURRe'jT C’DE IN C9RE, 

RcTuP'l 
30 CZ.vTiN '6 


R£40 REca: fr?h file, 

R6A3(U lT*CCA<Ca3PCC*n )"»LrFER 

o«: T^ ?o 

END 


3. 4. 4. 4 Subroutine FASRPT 


This subroutine uses information in common block RCMNl, which 
is the header record of any of the FLDSTT output files, to 
print the Fieldstats Acquisition Summary Report. The report 
gives the segment number, the acquisition date, the sun angle, 
g^u 1 una, the count of each class and type of pixel, the number 
of different crop codes found, and the overall means for each 
of the four channels of image unload data. 


7f 















L.’sfihj 


Sw.<« 'ytiNk F AS‘-eT(PK\T';, f>UA U ) 

C 

C ’Htr. SOti»?l'Tl>F P^K.TS F16LC*=^^^? ACOOISITI.'- •IJf'F-iKv 

c Pep."?!, ivjT IS 

c 

f PRST^ • I.T61EP P«r.T£C UNIT KUf-Bt«, 

C 

C P0*TE • 9-”YT6 A.^tAY CC'ITAIMaC Tt-fc CCOPENT TA^E (*ScH), 

C 

C phTR - 36C*«’pn a-pav CjMTAFrC IHg MEaTEP »EC^PD Fb3M 

C TwF FICL''S*ATS F lE| (/hCAM/) 

C 

I^'PlICIT rTrfi".B#2 (4-?) 

INTtScP*** AC'T' 
qvTE p^aTEJ?) 

Cr*''M^' /(»€*■•■ l/F'-'n^(.'^60 ) 

Dlf^E- S\2' PC' T(5>.PCLE''’(A) 
peal "(A) I '’•4” 

EOL'I V4i EVCF f PC\T, rh''t« ( ) ) , ( y , FniX it ) } I ( pCLSS# PHin« ( 2fl> ) # 

• <S‘S»FKD''('’))»(4'’'3'J|PkiFK(lC)),(SA.rHnp(l?))# 

• ( jA-»F'<L. (?6) ) . (' CC,F> ^F(2<) ) 

JPIVF (I’RN'TP, 10'' JP^ATE 

40QP FJP-ux»3.w1,?''y, '■F irt'-iiTAT aCCuISITUn SL^f, aRY ' /31X. 9a1 ) 
v;R I TP ( t'RNTP, '.i;0i >SP«, A'"3'', P A» GAV, 

4001 F<;p,'' 4T(4X, l4, ' sE J-E*'T '/ sx . I*, ' CATE '/6*, 12, • $0'' 4NGL£»/1X» 

• FT I 4.' Pi“MA») 

WR I TP (PR'.'TP, 4«0> IP.'OL'^S ( 1 ) , .CC 

4C0? F2P;,aT( 1H0,6'', IS» ' PUTc ' I XELS ' 1 1£ * . 1 3 , ' C»2P C30ES*, 

• ' PP'/.'CE''SEC ' ) 

L'R I TP < PRN TP , A 0 r> 3 > p : l* i, ( 2 ) 

4003 F;>hf‘4T(9X, I5>, • 2-CLAS>S PIycLS') 

D2 ir t«i.4 

viRITFloR' TP,-io‘'a)P:lSS( I*2)i ( I )i I 

4004 F2F,‘’AT(9lf» I5» 13, *-CLAS« Plvt S ’ , it'T , f 9 , « , • CMA''NFl ' 1 1 2. ' H?A*J') 
10 C£‘'-'T t'ii E 

WRITP(rH‘ T®, AC'‘'5JPCNr 

4005 FBPmaT(//9V, IS, ' • P 1 XtiS ' //9 X , 1 1 , * OASeLEr PIYELS'/9x, 

• 15,* CLjiUO PlxPus'/9X, I5i • SPAC^W P I XEl.S ' /9X , 1 5 • 

• * X’aTER PIXELS') 

RETu"N 
END 


I 

! 

■ 


3. 4. 4. 5 Subroutine FGPRPT 


This subroutine uses file header information in common block 
RCMNl, crop code translation information in common block 
RCMN3, and information read from the dot pixel statistics file 
to print the Fieldstats Dot Pixel Statistics Report. The report 
gives the segment number, the acquisition date, the sun angle, 
gamma, and, for each of the 209 dot pixels, the dot pixel 
number, the four image unload channel values, the screening 
label, and the six subpixel crop code translations. 
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S0b« *uTp.fe rr^.'rT(ppvm',Pi,ATf-,iJMT) 

Tr*!S SUbn*;liTl .E n^IKTS Ti.p FlfeLCSTiTS GpiD PIX6L •^PPKRT, 

I .POT IS 

pb.‘TP - IvTEGEP primes’ unit 

pD*TE • ?.PyTE array CfyTAlNlNG T»E CURRENT DaTE (AScH). 

•IKIT - integer I' T5R».-Eri ate I^PlT UkiT NUMBER, 

fCT - IaTeCEP*? ARRav CM'iTAlNIfG UR?P CJ3c 
TRAr,SF.-*KMA I p ,3, (/KC-'iNJ/) 


rhOR - |NtEGER*2 aRRaY CPNTaInING T^p tIlE HRAnER, (/RCmni/) 


iMPuciT integer*? (A-n 

0IfE‘SIl<N nufFi"R(?70> 

CJR- ■•n/RCmvj /PhrP ( ,T60 ) , /nc '’'•>''/CCT( 2Sft ) 

RYTE P*'ATE(9) 

U.TEGkP#'* acGDTE 
real Gamma 

eOUIVAicNCE (3r*,»r-ii)»(P)),(AnGf“TE,f>-0R<l'J)), 

• (S1J‘>NG,PH'JH( i?) > , KiAiif A ,FM:m ( ?6 n 

PRI\T HEacPb, 

RRITE C>RNTP, AcRgIP-^ATc 
400T FtJ‘MAT(lH1.4 '’X» 'PISl^STaT r;i!ln PixFt. R EP T • /5? X , 9 A 1) 
>ARITf(p..i JTR, 4J'.\ )S"(i, ACC’ir ,'jj'A* G,GA^^A 

4001 FJNriAT(4X, 14, • SEG 'E' TV 5a, 1!?, ' OaTE V 6A , I 2, • SUN AnGL'^VXX, 

• F7.4, • <;a*V,a V) 

L 1 • R N 3 s 1 

10 CH.jTt , 'E 

1F(LI '|P.'|A,EQ,7/ ARlTj;{PTNTR..l0a6) 

4006 FORHATriHl) 

RtAD(U‘ lT)UuRf‘=R 

^HIT=('’R'iT»,401?> (■••OFFER! M , I s 1 , 2 17 , 12 ) 

4002 FJR‘(ATaX,19( I3,3X) > 
nj3 2 1 /si, 4 

MRITp(oRNTR,4003)(tuFFER(I*O,I»1,2i7,12) 

4003 F^R nT(l7(?X, » 

20 C^'iTlN^'c 

■JRI T= ORNTP, 4004 ) (RUPFRR( I),!;12,22Sil2) 

4004 F3K,'IAT(2X,19( l?,4x) ) 

D3 <s5, 10 , 2 

WRITF(5crgTR,40*5>(GCTr)urFPR(l*K)*-l)iCC!lE:jFF£9(l4<*l)*l)# 

• 1=1,217,1?) 

4005 Fi,'‘VAT(lX,39(4?.lX)) 

3C C:''TI 'J’iE 

IF(lI ,^.N>\EO,11)R£TuPN 
LINE' OsL I Nr 
02 T7 10 
EAD 



3. 4. 4, 6 Subroutine FCCSRP 


This subroutine uses file header information in common block 
RCMNl, crop code translation information in common block 
RCMN3, and a buffer of per crop code information in common block 
RCMN2 to print the Fieldrtats Crop Code Summary Report. The 
buffer in common block RCMN2 is a composite of records read 
from each of the three pixel type output statistics files from 
FLDSTT. The report gives, for each occurring crop code, the 
crop code numeric value, the crop code translation, the segment 
number, the acquisition date, the sun angle, gamma, and then 
for each pixel type (pure, mixed, and subpixels) , the count of 
pixels, the four channel means, the four channel standard 
deviations, the cross-channel correlations, and the maximum and 
minimum values from the brightness and greenness histograms. 
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SU^l<*UTi^E rCCSKP(P«‘ T », "CaTE ) 

TilS SUf>H.;CTlNE o,<l',TS Tk.fe riELtSTMS CH*P C30E Summary pfePaPT, 
Input IS 

PRNTR • I-.TECE^ »3!\Tc« L'tT ^U►^■cP, 

PD*TE - 9-9YTE A'RAY C7.TA I,\ I .\G Thfc CUPSpNT :aT£ (AScID, 

PUfT'-S - lNT!:GrPt2 aPPAy C'nTaINJnG a -p-p cTOP STATISTICS 
pEcrPT rp?f T' e riEUSTAis tile, (/pc-n?/> 

rnCR - I'TPGPR*2 apmaY cPnTaInT^C Ti-E pile mFa''EB, (/HCm*i/) 

CCT •• I-'TeGEPa? aPcav C?‘.Ta 1.* PC CM^t. c?06 
Tr, a\SF.’R‘'AT I -f.S , (/RCM'.J/) 

If'EuCIT P'Tr2‘'P*2 (A-?) 

/RCMM/PNDR<36U),/H*.‘'N2/oirEe»'(H6C)»/PC'1N3/CCT(256) 
aVTE PrATE(9) 

CP e* SIC‘1 MMf 1?) 

INTEr.EB»4 *C'1C:T.F,0I?"F (2fce ) 

PfcAt. Gamma, -.PC* TiRiUMS?") 

EQi.'IVAi E*;C5 <c'.'rFEP(?) , A - '.r ) , (- jFFES (6 22 ) .'jPv'P) . 

• (sPGiFMUPjPiiiCAt-or. Tp,rHCfiCO)), 

• (SUNA|\C,PM">Pa>) > , (Gam' A,FMr,H(,6) ) 

PRINT weacFp, 


WRITP(?RNTP,40f'C)PlATE 

4000 r",iP,MAT(lHl, 2 lx, iFlPtrSTAT CR(’P C:uE StM,»4fiv'/3lX.9Ai) 

WRITP(PRNTP, AOOiIdurrcPd ). CCT I g.iPPcR (!)♦!) ,SEG,ACODTfe,Sil,\iA*gG, 

• Gamma 

reR>lAT(5X, 13, ' /'.K, A2, ' CP?P ^ A^g • /ax , i 4 , • SEGME mT V 3Y , ' 

• 15,' Cats ' /6 / , I" , 

• • SUN A‘ oLE VIM,.; V , ' GA-'.iA '// ' -.-.-.pjRg PIXELS------ ', 

• '-----f l-ifcD P’.XClS---""- -------SUEpIxElS----'--*/) 

WPCNTsr'lRUFd )/A.O 

WHITP(PR*lT.», < 0 ''?)BOrr 6 "d', ) ,B'jfF=R( 226 ) , .^FC ’ 

4002 FJP'iAniX, 15, ' oIXhLS' . 1 ?X. ! ,' A I XE US ' , 11 X , F 6 . 1 , • PIXELS'/,' 

WRITF(oRmTP,4003) 

F£RmaT(3(6X, '*C4'.S',13X) » 

PRINT "^EAnS FiiR CACW CUAV'JEl, 


DO 10 tal,4 

WRI TP (OR nR, 4004 ) 1 ,R'’Uf ( I ) . 1 1 RFUF (140* I ) ♦ 1 , R0UF(296*1 ) 

04 F2.RMAT(lX,3ni,2X.P9,4, 12X) > 

10 CO'.TI'J lE 

WRITE<pR'jTR,4V'i5) 

05 Fk)PMAT(/3(4x,'STAN"APU',12X)/3(3x,'CEv!ATi3SS',uxn 

PRINT STANPaRD DcVlATP.S F^R =aCP CHANNgL, 


20 

4006 

C 

C 


DO 20 lsl,4 

WfIITP(BRNTR, 4004 ) I,PR0P(4*I ),I,R5or(152*l), 1 , R^s'JF ( 3 3 0 * 1 ) 

CO'.T»N"e 

RRI rP{PR‘iTR, 4006 ) 

r^»MAT(/3( 7X, 'C^RRElaTI/ jS' ,5X) ) 


FRl.d CCRRElATI J>! ‘'AT.iix (Uopc> hAwF ) , 
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c 
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4 . OPERATIONS 


4 . 1 OPERATOR'S GUIDE 

4.1.1 IMUNLD PROGRAM 

When the operator receives an IMUNLD batch run, he should 

perform the following steps s 

1. Log onto the system under UIC[5,5]. 

2. Check system time and date for correct entry. 

3. Mount the Image Unload tape (specified on the Run Request 
Form, Figure 4-1) without a write ring ta a foreign tape. 

4. Mount the AA RP04 disk (specified on the Run Request Form) 
on DB2 : . 

5. Check the IMUNLD card deck to ensure that the second card 
after the $CREATE IMUNLD.DAT card contains the tape drive 
ID that matches the drive on which the tape was mounted. 

6. Load the card reader with the IMUNLD card deck and start 
the batch processor. 

7. At the end of the run dismount the tape and disk, and return 
the card deck. Run Request Form (signed off) , Image Unload 
tape, and printer listing to the user, and the disk to its 
locker . 

4.1.2 FLDSTT PROGRAM 

When the operator receives a FLDSTT batch run, he should perform 

the following steps: 

1. Log onto the system under UIC[5,5j. 

2. Check system time and date for correct entry. 

Mount the AA RP04 disk (specified on the Run Request Form) 
on DB2 : . 
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. Load the card reader with the FLDSTT card deck and start 
the batch processor. 

5. At the end of the run, dismount the disk and return it to 
its locker, and return the card deck. Run Request Form 
(signed off) , and printer listing to the user. 

4.2 USER’S GUIDE 

4.2.1 BATCH PROCEDURES 

4. 2. 1.1 IMUNLD Program 

To run the IMUNLD program in batch, the user should perform 
the following steps; 

1, Prepare the following deck of cards: 

$ JOB /NAME- IMUNLD/LIMIT»9 9 9/ACCOUNT- 110 6/MCR 
$CREATE IMUNLD.DAT 
Data Set 1 

$EOD 

$MCR REM RSXBAT 
$RUN IMUNLD. TSK 
$EOJ 

Where Data Set 1 contains the three cards described below: 

Card 1 - contains a 2 in column one to indicate that DB2 : is 
the drive for the AA disk. 

Card 2 - contains the input tape drive device ID in the first 
three columns, for exeunple, MT0 or MTl. This card will be 
adjusted by the operator if he needs to use a different drive 
than the one specified. 

Card 3 - Contains the tape number in the first six columns. 

This number will be checked against the number stored internally 
on the tapf 

2. Complc ;! the NAME, ORGANIZATION/PHONE, DATE, TAPE 
IDENTIFICATION, OTHER INFORMATION (specify what AA RP04 disk 
to use) boxes, and check the PRINTOUT box on the Run Request 
Form (Figure 4-1) . 




3. Submit the Image Unload tape, the card deck, and the Run 
Request Form to Operations for runnin.. on the Image Processor. 

4. After the program has been run, retrieve the tape, card 
deck, and printout, and sign the bottom of the Run Request 
Form to indicate receipt of the output. 

4. 2. 1.2 FLDSTT Program 

To run the FLDSTT program in batch, the user should perform the 
following stops: 

1. Prepare the following deck of cards: 

$JOB/NAME»FLDSTT/LIMIT»999/ACCOUNT»110 6/MCR 
$MCR PIP FLDSTT.DAT; */DE 
SCREATE FLDSTT.DAT 
Data Set 2 

$EOD 

$MCR REM RSXBAT 
$RUN FLDSTT. TSK 
$EOJ 

Where Data Set 2 contains the four to six cards described below: 
Card 1 - contains, in the first thirty columns, the file ID 
where the crop code translations and brightness and greenness 
coefficients are stored. The file name is FSTLBL.DAT, but this 
card should include the specific device and user file directory 
to enable location of the desired file, for example, DB2 ; [ 131 , 0i?ll 
FSTLBL.DAT. 

Card 2 - contains, in the first thirty columns, the file ID 
where ground truth data are stored. After this file is assigned, 
this character string is modified and used to create the output 
files, therefore it must be very exact in format. For example, 
the file ID DB2: (131, 161177353. GT0 is acceptable (the 
acquisition date must be in columns eighteen through twenty-two) . 

Card 3 - contains three fields: 

Field 1 - c )iur ,is one through four - contains the segment number 
to processed. This is cliecked against the number 
stored internally on the ground truth file. 


Field 2 - columns six and seven - contains the output report 
option flag. This is a two-digit decimal number 
specifying which output reports are desired. The 
number is the sum of the numbers assigned ‘t ,■> the 
various reports. The Acquisition Summary report is 
always produced, whereas the Dot Pixel Statistics 
report (assigned number 1) and the Crop Code Summary 
report (assigned number 2) are optional. 

Field 3 - columns nine and ten - contains a two-digit decimal 

n’omber, greater than zero and less than sixteen, which 
specifies how many acquisition dates are to be processed 
during this run of the FLDSTT program. Note that each 
acquisition date processed will take one hour of 
elasped time at a minimum. 

Cards 4,5, and 6 - contain fifteen fields which are the acquisi- 
tion dates to be processed, represented in standard 
YYDDD format. On each card there are five five-character 
fields, starting in column one and skipping five spaces 
between each field. Cards 5 and 6 do not need to be 
present if they are not needed. 

2. Complete the NAME, ORGANIZATION/PHONE, DATE, OTHER INFORMATION 
(specify what AA RP04 disk to use) boxes, and check the 
PRINTOUT box on the Run Request Form. 

3. Submit the card deck and Run Request Form to Operations for 
running on the Image Processor. 

4. After the program has been run, retrieve the card deck 2 ind 
printout, and sign the bottom of the Run Request Form to 
indicate receipt oi the output. 


4.2.2 ONLINE PROCEDURES 


4. 2. 2.1 IMUNLD Proorain 

To run the IMUNLD program from an interactive terminal, the 
user should sign on to UIC[110,6] , have the proper tape and 
disk mounted, create the file IMUNLD.DAT containing Data Set 1 
(described in 4. 2. 1.1), and execute IMUT^LD.TSK. 

4. 2. 2. 2 FLDSTT Program 

To run the FLDSTT program from an interactive terminal, the user 
should sign on to UIC[11C,6], have the proper disk mounted, 
edit the data in Data Set 2 (described in 4. 2. 1.2) in file 
FLDSTT.DAT and execute FLDSTT. TSK. 



